HAL custom cardholder verification functions API

HAL custom cardholder verification functions Interface. More...

Macros
#define	KER_CHECK_CUSTOM_CVM_COND(CVM, Condition)   KER_FALSE
#define	KER_CHECK_CUSTOM_CVM(CVM)   KER_CVM_RES_UNREC
#define	KER_APPLY_CUSTOM_CVM(CVM, OutcomeCVM)   KER_CVM_RES_UNREC

Typedefs
typedef KER_BOOL(KER_API *	CALLBACK_CV_CHECK_CUST_CVM_CONDITION) (KER_CTX_PARAM KER_VOID *pCallbackHandle, KER_BYTE btCVM, KER_BYTE btCondition)
	Callback type for check custom cvm condition. More...
typedef KER_BYTE(KER_API *	CALLBACK_CV_CHECK_CUST_CVM) (KER_CTX_PARAM KER_VOID *pCallbackHandle, KER_BYTE btCVM)
	Callback type for check if custom cvm recognized and supported. More...

Detailed Description

HAL custom cardholder verification functions Interface.

This functions should be implemented by terminal application to support custom cardholder verification methods

Macro Definition Documentation

KER_APPLY_CUSTOM_CVM

#define KER_APPLY_CUSTOM_CVM	(		CVM,
			OutcomeCVM
	)		KER_CVM_RES_UNREC

\ <>

KER_CHECK_CUSTOM_CVM

#define KER_CHECK_CUSTOM_CVM

(

CVM

)

KER_CVM_RES_UNREC

\ <>

KER_CHECK_CUSTOM_CVM_COND

#define KER_CHECK_CUSTOM_CVM_COND	(		CVM,
			Condition
	)		KER_FALSE

\ <>

Typedef Documentation

CALLBACK_CV_CHECK_CUST_CVM

typedef KER_BYTE(KER_API * CALLBACK_CV_CHECK_CUST_CVM) (KER_CTX_PARAM KER_VOID *pCallbackHandle, KER_BYTE btCVM)

Callback type for check if custom cvm recognized and supported.

Parameters

[in]	pCallbackHandle	- callback context, obtained from Terminal Application, and stored by hal_register_callback (btCallbackType = KER_HAL_CALLBACK_HANDLE)
[in]	btCVM	CVM from CV Rule to be aplied

Returns

KER_CVM_RES_OK cvm supported

KER_CVM_RES_UNSUPP cvm unsupported

KER_CVM_RES_UNREC cvm unrecognised

KER_CVM_RES_FAIL failure

This callback is optional. Check custom cvm can be implemented by the hal itself (KER_CHECK_CUSTOM_CVM)

CALLBACK_CV_CHECK_CUST_CVM_CONDITION

typedef KER_BOOL(KER_API * CALLBACK_CV_CHECK_CUST_CVM_CONDITION) (KER_CTX_PARAM KER_VOID *pCallbackHandle, KER_BYTE btCVM, KER_BYTE btCondition)

Callback type for check custom cvm condition.

Parameters

[in]	pCallbackHandle	- callback context, obtained from Terminal Application, and stored by hal_register_callback (btCallbackType = KER_HAL_CALLBACK_HANDLE)
[in]	btCVM	CVM from CV Rule to be aplied
[in]	btCondition	from CV Rule to be aplied

Returns

KER_TRUE Condition met.

KER_FALSE Condition not met.

This callback is optional. Check custom cvm conditions can be implemented by the hal itself (KER_CHECK_CUSTOM_CVM_COND)